home *** CD-ROM | disk | FTP | other *** search
/ Pascal Super Library / Pascal Super Library (CW International)(1997).bin / GRP_CVTR / REALIZ10 / REALIZE.DOC < prev    next >
Text File  |  1994-07-04  |  41KB  |  1,238 lines
  1.  
  2.  
  3.                              REALIZE Version 1.0
  4.  
  5.                              User's Documentation
  6.                             
  7.                     Copyright 1994 Transcendental Technologies
  8.  
  9.                              
  10.  
  11.  
  12. Transcendental Technologies is a member of the Association of Shareware
  13. Professionals (ASP). ASP wants to make sure that the shareware principle
  14. works for you. If you are unable to resolve a shareware-related problem
  15. with an ASP member by contacting the member directly, ASP may be able to
  16. help. The ASP Ombudsman can help you resolve a dispute or problem with an
  17. ASP member, but does not provide technical support for members' products.
  18. Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI
  19. 49442-9427 USA, FAX 616-788-2765 or send a CompuServe message via CompuServe
  20. Mail to ASP Ombudsman 70007,3536.
  21.  
  22.  
  23.  
  24.  
  25.  
  26. Table of Contents
  27.  
  28.  
  29.    
  30. Part 1. Introduction
  31.  
  32.  
  33. Part 2. System Requirements
  34.  
  35.  
  36. Part 3. Quick Start
  37.  
  38.  
  39. Part 4. Command Line Parameters
  40.  
  41.  
  42. Part 5. Representative Blocks
  43.  
  44.  
  45. Part 6. Samples - a Quick Tutorial
  46.  
  47.  
  48. Part 7. Directive File
  49.  
  50.  
  51. Part 8. Directive File Syntax Reference
  52.  
  53.  
  54. Part 9. Tips
  55.  
  56.  
  57. Part 10. About POV
  58.  
  59.  
  60. Part 11. Error messages
  61.  
  62.  
  63. Part 12. Definition of Shareware
  64.  
  65.  
  66. Part 13. Registration
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74. Part 1. Introduction.
  75.  
  76.  
  77.  
  78.     REALIZE is a full-featured, one-step dxf file to POV ver 2.0 converter.
  79.  
  80.     For  those not  familiar  with POV  -  POV is one of the best (if not
  81. the best) ray-tracers available. POV's incredibly rich decription language
  82. allows truly photo-realistic renderings.  If you have a 3D or even a 2D
  83. drawing in dxf format that you would like to present in an impressive sort
  84. of way or perhaps you just like to visualize the finished product, REALIZE
  85. will convert it to POV format which can then be rendered in the most realistic
  86. method - ray-tracing.
  87.  
  88.     Among the various rendering methods, ray-tracing is the most realistic
  89. and, consequently the slowest and most calculation-intensive.  The ray-tracing
  90. algorithm follows the actual physics of light to come up with the level of
  91. quality that is unachievable with any other process.
  92.  
  93.     For those not familiar with the .dxf file format - dxf (Drawing interchange
  94. file format) is a nearly universal format to convey drawing information.
  95. Most notable systems are AutoCad, AutoCad Lite, Cadkey, etc.
  96.  
  97.     Even if you don't own any of these powerful CAD packages, you can still
  98. use REALIZE as long as your drawing package can produce a line in .dxf format.
  99. REALIZE can extrude your 2D lines and/or "fatten" it to produce POV description
  100. language code for realistic 3D images (see demoplan.rdr).
  101.  
  102.     REALIZE is easy to use - merely specify the dxf file then the output file
  103. name and the result is an optimized, annotated, ready-to-render file. REALIZE
  104. can automatically add various kinds of "floors" and "skies" to the rendering
  105. (see Command Line Parameters and Directive File Syntax). The rendering
  106. perspective is automatically converted to "camera" location.  REALIZE even
  107. provides (as a default) an automatically positioned "light source" (see
  108. Samples).
  109.  
  110.     REALIZE has a special feature. Representative blocks allow dxf blocks
  111. to be replaced by shape primitives that POV is notable for (spheres,
  112. cylinders, cones, quartics, height-fields, etc.). In other words, not
  113. only triangles may be used to build up the shapes, but also infinitely smooth
  114. spheres and toruses can be used (see Samples).  REALIZE comes with
  115. a library of representative matching blocks which are ready to use.
  116.  
  117.  
  118.  
  119.  
  120.     REALIZE recognizes and converts:
  121.  
  122.         - 3D entities (polyface,3d faces,3d meshes)
  123.             with automatic smoothing of faces (see Directive File Syntax)
  124.  
  125.         - 2D entities (line, circle, polyline, solids, arcs)
  126.             with extended 2D features like beveling (see Directive File Syntax)
  127.  
  128.         - simple and nested blocks
  129.             with texture assignment (see Samples)
  130.  
  131.         - representative blocks (see Representative Blocks)
  132.  
  133.         - layers
  134.             with texture assignment (see Samples)
  135.  
  136.         - views
  137.  
  138.         - viewports
  139.  
  140.         - the full 256 AutoCad color set
  141.             with each color assignable to any POV pre-defined or user
  142.             defined texture.
  143.  
  144.  
  145.  
  146.  
  147.     The directive file feature:
  148.  
  149.         - allows global and block or layer level control of texture
  150.             assignments
  151.  
  152.         - allows automatic bit-map positioning
  153.  
  154.         - supports CSG or Constructive Solid Geometry (Unions and
  155.             intersections of POV shapes)
  156.  
  157.         - triangle smoothing control based on seam angle, block grouping,
  158.             or layer grouping
  159.  
  160.         - "blobs" conversion
  161.  
  162.         - allows 2D special effects
  163.  
  164.  
  165.  
  166.     In short, if you've got a .dxf file REALIZE will convert it to a
  167. photorealistic image (via POV)- painlessly. It's a case of WYSWKYO (What You
  168. See Will Knock You Out!).
  169.  
  170.     Please note: POV (or Persistence of Vision) version 2.0 is not included
  171. in this package.  However, it will cost you next to nothing to acquire POV
  172. as it is freeware and costs nothing (except perhaps a copying fee). See
  173. About POV for details on how to get the latest version.
  174.  
  175.     This package has been tested extensively on .dxf files generated by AutoCad
  176. release 12.  Any .dxf file that conforms to this standard and is readable by
  177. AutoCad should be convertible by REALIZE.  Any .dxf file format which does
  178. not conform closely to this standard may produce problems.
  179.  
  180.  
  181.  
  182.  
  183. Part 2. System Requirements
  184.  
  185.  
  186.  
  187.     Minimum System Configuration Required:
  188.  
  189.         286 with 512 k memory, hard disk with about 10 MB free (for programs
  190.         and work space), DOS 5 or higher.
  191.  
  192.  
  193.  
  194.     Preferred Configuration:
  195.  
  196.         386/486 with above memory and a disk-cache installed.
  197.  
  198.  
  199.     Note that POV requires a minimum of 386 processor (with co-processor)
  200.     and 4MB memory.
  201.  
  202.  
  203.  
  204.  
  205. Part 3. Quick Start
  206.  
  207.  
  208.     First, you'll have to install REALIZE.  Unzip all files with the -d or
  209. stored directory option. It is preferable to put REALIZE in a directory
  210. called \realize. Copy realize.zip into \realize then use pkunzip:
  211.  
  212.     pkunzip -d realize.zip *.*
  213.  
  214.     (assuming your current directory is \realize and realize.zip is in it).
  215.  
  216.     Second, you'll need your dxf file.  This will have to be in ASCII form.
  217. If the digits accuracy is adjustable, set it to at least six digits. Make
  218. the REALIZE directory your current directory.
  219.  
  220.     Then execute REALIZE from DOS:
  221.  
  222.     REALIZE <.dxf file> <output file>
  223.  
  224.     Do not include the "<" or ">" symbols nor the extentions. REALIZE will
  225. generate a .pov and a .inc file with the name of <output file>. You may include
  226. legal paths for both parameters.
  227.  
  228.     For example:
  229.  
  230.     realize c:\acad\ship c:\acad\ship
  231.  
  232.     (This will convert ship.dxf in c:\acad to ship.pov and ship.inc in the
  233.     same directory.)
  234.  
  235.     Invoke POV (ver 2.0 or higher) to render the .pov file.
  236.  
  237.     If your copy of POV is not installed in its default directory (\povray),
  238. then you need to edit pov.bat and change the indicated line to include the
  239. correct directory.
  240.  
  241.     Run pov.bat:
  242.  
  243.     POV <output file>
  244.  
  245.  
  246.     with <output file> format same as above.
  247.  
  248.     For example:
  249.  
  250.     pov c:\acad\ship
  251.  
  252.     (Following the previous example, this will convert ship.pov in c:\acad
  253.     to the .tga format containing your finished picture.)
  254.  
  255.  
  256.     Lastly, admire the image.  This would be in .tga (24 bit TARGA) format.
  257. You will need a viewer and may have to convert the 24-bit image to an 8-bit
  258. one unless you are lucky enough to have access to a 16M-color display
  259. system.
  260.  
  261.  
  262.     The image may not appear exactly as you wanted for several possible
  263. reasons:
  264.  
  265.     1) REALIZE generates its own default camera and lighting view. If you
  266. haven't described any perspective view or viewport that was active when you
  267. generated the dxf file then the camera and/or light may not be ideal.  See
  268. Tips. Also if you specify the camera to be directly above the target, REALIZE
  269. will revert to its default.
  270.  
  271.     2) The image may look to be too close or too far from the camera. This
  272. is because a distance was not specified or a perspective view was not active.
  273.  
  274.     3) There may be little or nothing to convert.  REALIZE will ignore all
  275. text (but see Registration - Benefits) and will convert only 3D entities
  276. and extruded and/or thickened 2D entities. Mathematical lines (single dimension)
  277. and points (no dimension) will normally be ignored (see Directive file under
  278. 2D Extensions for exceptions).  For handling of special entities see Tips.
  279.  
  280.     4) REALIZE will follow the original default colors if no texture directives
  281. (see Directive File and Samples) are specified.
  282.  
  283.  
  284.  
  285. Part 4. Command Line Parameters
  286.  
  287.  
  288.  
  289.     The first parameter is required and is the dxf file with no suffix.
  290.  
  291.     The second parameter is required and is the output file. It also may not
  292. have a suffix.
  293.  
  294.     The optional parameters make appear in any order and take the form:
  295.  
  296.         /<option>:<value>
  297.  
  298.     Optional parameters are always separated by spaces and are case-insensitive.
  299.  
  300.     <Option>'s and valid <value>'s are as follows. Defaults are assumed if the
  301.     parameter is absent and no directive in the directive file is found.
  302.  
  303.  
  304.         S - sky <sky type>:
  305.  
  306.                 C - Cloudy skies (default)
  307.                 D - sky at Dusk
  308.                 N - No sky - all black (quickest to render)
  309.                 B - clear Blue sky
  310.  
  311.         F - floor <floor type>:
  312.  
  313.                 G - Grassy
  314.                 R - lake Ripples
  315.                 W - ocean Waves
  316.                 N - None - up in the air (quickest to render)
  317.                 T - Tiled floor (classic red and white - the default)
  318.                 D - Desert
  319.  
  320.         A - Altitude <nnn>. Zero is the default. This puts the floor under the
  321.             lowest point of the drawing. Negative values put the object under
  322.             the floor.
  323.  
  324.         L - autoLight <y or n>. A 'y' enables automatic lighting (default).
  325.  
  326.         T - default global Texture <texture type>:
  327.  
  328.                 T - maTte
  329.                 P - Plastic (default)
  330.                 L - gLossy
  331.                 M - Metal
  332.                 R - Reflective
  333.                 G - Glassy
  334.                 U - lUminous
  335.  
  336.         V - View <view name>. Default view is the active view when the dxf file
  337.             is generated. Use this to generate different named views without
  338.             editing the rdr file (see Directive File).
  339.  
  340.         D - directive file <file name>. The default directive file is the same
  341.             name as the dxf file but with the suffix .rdr.  If this file is
  342.             absent the rdr file is assumed to be default.rdr.
  343.  
  344.  
  345.  
  346.  
  347. Part 5. Representative Blocks
  348.  
  349.  
  350.     Most CAD packages allow special constructs called blocks to be inserted
  351. into drawings. REALIZE allows these drawing blocks to be replaced in the POV
  352. file by any pre-defined object, simple (like spheres or cubes) or complex
  353. (unions of simple object). As long as the drawing blocks are reasonably close
  354. to the final blocks (POV), and as long as they are properly defined to REALIZE,
  355. these "representative blocks" can be inserted in the drawing by the CAD package
  356. then rotated, positioned, scaled in any direction, or colored, and in some
  357. cases, used in Boolean operations.
  358.  
  359.     REALIZE comes with the basic set of blocks in dxf and AutoCad dwg format.
  360. An examination of the file defaultp.rdr will show how the representative blocks
  361. are assigned to their POV counterparts.  The syntax is detailed in "Directive
  362. File Syntax Reference" under "Block Directive".
  363.  
  364.     The user is not limited to this basic set.  The registered version of
  365. REALIZE comes with an extended set (see Registration).  The advanced user
  366. may create his own blocks.
  367.  
  368.  
  369.  
  370.     Installing Representative Blocks:
  371.  
  372.     If you are using an Autodesk Product like AutoCad or AutoCad Lite, the
  373. blocks are already in useable form in the BLOCKS subdirectory.  Just INSERT
  374. them into your drawing and supply the necessary directive statements in the
  375. .rdr file.  For other CAD packages just convert the .dxf files in the BLOCKS
  376. directory to the CAD package's native format then insert them. As before,
  377. the .rdr files are required (see Samples).
  378.  
  379.  
  380.  
  381. Part 6. Samples - a Quick Tutorial.
  382.  
  383.  
  384.  
  385.     This section deals with the samples which show the features that modifies
  386. the basic conversion process to produce a more realistic render.  The samples
  387. are a collection of .rdr files and .dxf files that produce .pov files which
  388. can then be rendered and studied.
  389.  
  390.     To render a particular sample, make \realize\samples your current directory
  391. then type :
  392.  
  393.         sampnnn
  394.  
  395.     where nnn is the 3 digit number of the sample. For example:
  396.  
  397.         samp003
  398.  
  399.     invokes samp003.bat and renders sample number 3.
  400.  
  401.     The result will be a .tga file called sampnnn.tga(samp003.tga in this case).
  402.  
  403.  
  404.     To render all samples in evaluation package, type:
  405.  
  406.         sampall
  407.  
  408.     This would take hours and will cost you a lot of disk space but will be
  409. a good reference library.
  410.  
  411.  
  412.     To render all samples in registered package, type:
  413.  
  414.         sampreg
  415.  
  416.  
  417.  
  418.  
  419. IMPORTANT:
  420.  
  421.     These .bat files call pov.bat so be sure that you have the right path
  422. in it for the POV executables.
  423.  
  424.  
  425.     The sample files are listed here for convenience:
  426.  
  427.  
  428.     Quick Start (2D to 3D, Simple Texturing, Representative Blocks):
  429.  
  430.  
  431.         001 - Default directives for sky and ground generation (Introduction)
  432.         002 - Different Floors and sky (sea)
  433.         003 - Different Floors and sky (desert and clear sky)
  434.         004 - Representative Blocks for smoother objects
  435.         005 - Global finish (Metallic)
  436.         006 - Global finish (Glassy)
  437.         007 - Different Finishes
  438.         008 - 2D lines to 3D objects
  439.         009 - Standard Shapes
  440.  
  441.  
  442.  
  443.     Intermediate Level Samples:
  444.  
  445.         010 - Normal effects (Bumps, Ripples, Wrinkles, etc.)
  446.         011 - Normal effects (different scales)
  447.         012 - Bit maps for pigments
  448.         013 - Bit maps for normals
  449.         014 - 2D lines to brick walls
  450.         015 - Blimps
  451.         016 - Advanced lighting
  452.  
  453.  
  454.     Advanced Samples:
  455.  
  456.         017 - Smoothing Control
  457.         018 - 2D bevels and balloons
  458.         019 - Boolean Shapes
  459.         020 - Blobs
  460.         021 - Chandelier
  461.         022 - Crane
  462.         023 - External Textures (Stones and woods)
  463.  
  464.  
  465.     Samples in registered version package:
  466.  
  467.         024 - Text demo
  468.         025 - Tapers and Elbows
  469.         026 - Tree - Normal
  470.         027 - Tree - Autumn Colors
  471.         028 - Tree - Metallic
  472.         029 - Tree - Bare
  473.         030 - Fractal Mountain - Blue and Snowy
  474.         031 - Fractal Mountain - Painted
  475.         032 - Fractal Mountain - Snowy
  476.         033 - Fractal Mountain - Alien Landscape
  477.  
  478.  
  479.     Most of the samples from 026 to 033 require up to 20 Mbytes of virtual
  480. memory when POV renders them.  See Tips.
  481.  
  482.  
  483.  
  484.     Other samples (requires AutoCad Sample Drawings):
  485.  
  486.     These are only .rdr files. To have a look, generate the .dxf file with
  487. the corresponding name (say shuttle.dxf) and copy this into the samples
  488. directory. Then type (from the samples directory):
  489.  
  490.         ..\realize shuttle shuttle
  491.  
  492.     Then:
  493.  
  494.         ..\pov shuttle
  495.  
  496.  
  497.     The Other Samples are:
  498.  
  499.         colorwh.rdr
  500.         dhouse.rdr
  501.         kitchen2.rdr
  502.         nozzle3d.rdr
  503.         pentagon.rdr
  504.         pins2.rdr
  505.         sextant.rdr
  506.         shuttle.rdr
  507.         site-3d.r
  508.  
  509.  
  510.  
  511.  
  512. Part 7. Directive File
  513.  
  514.  
  515.     The directive file is a useful option.  It allows specifies certain
  516. operations to be assigned to a dxf files.  It normally is named after the
  517. dxf file that it operates on although this can be overridden (see Command
  518. Line Options).  The directive file has the .rdr extension.  The file
  519. called default.rdr is used as directive file when REALIZE is invoked if
  520. there is no rdr file explicitly specified or if there is no rdr file with
  521. the same name as the dxf file.
  522.  
  523.  
  524.     The directive file has several functions.  This includes:
  525.  
  526.     1) Assignment of Representative blocks.
  527.     2) Assignment of textures to color numbers, blocks, and layers.
  528.         This includes image maps.
  529.     3) Specification of global settings.
  530.     4) Smoothing control.
  531.     5) Extended 2D conversion.
  532.     6) Special operations like Boolean operations and blobs.
  533.  
  534.  
  535.     Refer to Samples for command line and .rdr files.
  536.  
  537.  
  538.  
  539. Part 8. Directive File Syntax Reference
  540.  
  541.  
  542.  
  543.     The conventions used in the FORMAT part is as follows:
  544.  
  545.     - Items in <brackets> are user-supplied. See notes for valid values.
  546.         The brackets are excluded in coding.
  547.     - Lower-case words are to be typed as is but is case-insensitive in the
  548.         actual coding.
  549.     - Items in columns within vertical lines are mutually exclusive options.
  550.     - items in square [brackets] are optional. The brackets are excluded in
  551.         coding.
  552.     - the syntax is free-format. Indentions are for readability only.
  553.     - the "..." means more follow. See additional syntax further down.
  554.     - Comments have an "*" in the first column. They are ignored by the
  555.         parser.
  556.  
  557.  
  558.     All directive types may appear more than once except for the global
  559. directive.  The texture directive may appear once for each color number that
  560. you want to define. The block and layer directive may appear once for each
  561. block and layer respectively. The insert POV directive may appear once for
  562. each type of insert.
  563.  
  564.     In the syntax, the "color number" or "color keyword" is mentioned. The
  565. number may assume a value of 1-255, each integer value representing a standard
  566. color. In place of a number, you could substitute a keyword which represents
  567. the number as shown in the following table:
  568.  
  569.  
  570.        keyword              color
  571.                             number
  572.  
  573.         red                   1
  574.         yellow                2
  575.         green                 3
  576.         cyan                  4
  577.         blue                  5
  578.         magenta               6
  579.         white                 7
  580.         orange               30
  581.         dark_grey           250
  582.         grey                252
  583.         light_grey          254
  584.         black                 0
  585.  
  586.     Note: the last value, "black" may not be valid in the specific instance
  587.         where it is used.
  588.  
  589.  
  590.     It is probably very useful to use the contents of this section in
  591. conjunction with Samples as some of the concepts may be difficult to grasp
  592. without graphic examples.
  593.  
  594.  
  595.  
  596. GLOBAL Directive:
  597.  
  598.  
  599.     The global directive defines settings that operate on the whole scene.
  600. Some of these settings are overrideable on a block or layer level (See LAYER
  601. and BLOCK directives).
  602.  
  603.  
  604.  
  605.  
  606.     Format:
  607.  
  608.     global
  609.  
  610.         sky <sky type>
  611.         sky_color │<nnn>    │
  612.                   │<keyword>│
  613.         floor <floor type>
  614.         floor_color │<nnn>    │
  615.                     │<keyword>│
  616.         altitude <nnn>
  617.  
  618.         autolight │yes│
  619.                   │no │
  620.         autolight_intensity <nnn>
  621.  
  622.         ambient_light <nnn>
  623.  
  624.         default_texture <texture type>
  625.         view <view name>
  626.         default_smooth_angle <nnn>
  627.         no_optimize
  628.  
  629.         default_top_bevel <nnn>
  630.         default_right_bevel <nnn>
  631.         default_bevel_iangle <nnn>
  632.         default_bevel_side │left │
  633.                            │right│
  634.                            │both │
  635.         default_2d_thickness <nnn>
  636.         default_2d_width <nnn>
  637.  
  638.  
  639.  
  640. Notes:
  641.  
  642.  
  643.     All settings are optional.
  644.  
  645.     The valid <sky type> values are:
  646.  
  647.         cloudy
  648.         dusk
  649.         blue
  650.         none
  651.  
  652.     The sky_color <nnn> is an value from 1-255 representing a color. The
  653.     keyword may be used in place of the color number as mentioned above.
  654.  
  655.     The valid <floor type> values are:
  656.  
  657.         grassy
  658.         ripples
  659.         waves
  660.         none
  661.         tiles
  662.         desert
  663.  
  664.  
  665.     For floor_color values see sky_color above.
  666.  
  667.     Autolight or automatic lighting can be turned on (yes) or off (no).
  668.  
  669.     Autolight_intensity is a value of 0-1, 0 being turned off, and 1 being
  670.         full intensity.
  671.  
  672.     Ambient light can be set from 0-1, 0 being turned off, and 1 being
  673.         full intensity.
  674.  
  675.     Default_texture settings define the default finish of an object if its
  676.         finish is not defined explicitly by any directive:
  677.  
  678.         matte
  679.         plastic
  680.         glossy
  681.         metallic
  682.         reflective
  683.         glassy
  684.         luminous
  685.  
  686.         This value may be overridden by other directives (see below).
  687.  
  688.     The <view name> is "named view" information in which camera-and-target
  689.         location are specified in the dxf file.
  690.  
  691.     The default_smooth_angle value may be from 0 to 90 and specifies the
  692.         maximum angle between 2 adjoining faces wherein smoothing will
  693.         take place. For example if 45 is specified, all seam angles of
  694.         less than or equal to 45 degrees will have the adjoining faces
  695.         smoothed.  All other faces will appear unsmoothed (see Samples).
  696.  
  697.         This value may be overridden by other directives (see below).
  698.  
  699.     No_optimize may be used to speed up the rendering for small scenes.
  700.         Try this parameter if the number of elements do not exceed 5000.
  701.  
  702.     The 2D default settings are described as follows. Note that these values
  703.         may be overridden by other directives (see below).
  704.  
  705.              setting                        values
  706.  
  707.         default_top_bevel          value 0-1 expressing top bevel as
  708.                                    portion of total width
  709.  
  710.         default_right_bevel        value 0-1 expressing side bevel as
  711.                                    portion of total height
  712.  
  713.         default_bevel_iangle       value 0-180 in degrees of bevel
  714.                                    included angle
  715.  
  716.         default_bevel_side         - if not specified, right is assumed
  717.  
  718.         default_2d_thickness       units thickness of 2D entity assumed
  719.                                    if not specified by dxf file
  720.  
  721.         default_2d_width           units thickness of 2D entity assumed
  722.                                    if not specified by dxf file
  723.  
  724.  
  725.  
  726.  
  727. TEXTURE Directive:
  728.  
  729.  
  730.     The texture directive assigns textures to any of the 255 color numbers.
  731. The assigned texture is then applied to any object which has the color.
  732. You must have one texture directive for each color you want to define.
  733. Any color number without a texture directive will assume the normal color
  734. associated with the number and the default texture (see GLOBAL directive).
  735.  
  736.  
  737.  
  738.     Format:
  739.  
  740.  
  741.     texture │<nnn>    │ │color │<nnn>    │                          │
  742.             │<keyword>│ │      │<keyword>│                          │
  743.                         │color_values <red> <green> <blue>          │
  744.                         │pigment_map ...                            │
  745.                         │normal <normal keyword> <nnn> <nnn>        │
  746.                         │normal_map ...                             │
  747.                         │finish <finish keyword>                    │
  748.                         │as_follows ... end_as_follows              │
  749.                         │external_texture <pre-defined texture name>│
  750.                         │external_pigment <pre-defined pigment name>│
  751.                         │external_normal  <pre-defined normal  name>│
  752.                         │external_finish  <pre-defined finish  name>│
  753.  
  754.  
  755.  
  756.       PIGMENT_MAP :
  757.  
  758.  
  759.         pigment_map <.gif file> on │plane...│   [up [-]│x│  right [-]│x│]
  760.                                    │cylinder│          │y│           │y│
  761.                                    │sphere  │          │z│           │z│
  762.                                    │torus   │
  763.  
  764.  
  765.         PLANE :
  766.  
  767.               on plane  │once    │
  768.                         │repeat n│
  769.  
  770.  
  771.  
  772.       NORMAL_MAP: AS WITH PIGMENT_MAP ABOVE PLUS:
  773.  
  774.  
  775.             [bump_size <nnn>]
  776.  
  777.  
  778.  
  779.  
  780.  
  781. Notes:
  782.  
  783.     Texture - the <nnn> or <keyword> defines which color number is to be
  784.         defined.
  785.  
  786.     Color assigns a different color to the color number.
  787.  
  788.     Color_values specify the intensity of the red, green, and blue components
  789.         of the color. Valid values are from 0.0 to 1.0.
  790.  
  791.     Pigment_maps are concerned with a class of texturing called mapping. A
  792.         prime example would be wrapping a two-dimensional map of the earth
  793.         around a three-dimensional globe.  For a graphic example, refer to
  794.         Samples (Bit maps).
  795.  
  796.     The <.gif file> refers to the file name (minus .gif extension) that will
  797.         be wrapped around the object.  The "on" keyword specifies the mapping
  798.         type. Keywords "up" and "right" specify the orientation - where the
  799.         upper side and the right side of the image will point (note that
  800.         you are allowed to point to a negative ("-") direction). In the case
  801.         of a plane, "once" and "repeat n" specifies the number of occurences
  802.         the image will appear in a 2x2 unit square ("repeat 3" would indicate
  803.         9 images in a tiled 3x3 array). Default 'up' is z, default right is 'x',
  804.         default type is plane and default occurrance is "once".
  805.  
  806.  
  807.     Normal keywords as follows:
  808.  
  809.         bumps
  810.         dents
  811.         ripples
  812.         waves
  813.         wrinkles
  814.  
  815.         These are followed by two numbers indicating the intensity (or depth)
  816.       and scale.
  817.  
  818.         See Samples for their effects.
  819.  
  820.     Normal_maps are similar to Pigment_maps but instead of pigmentation, they
  821.         "bump up" the surface (see Samples). The bump_size parameter indicates
  822.         the intensity of the bumpiness (from 0.0 to 1.0).
  823.  
  824.     Valid Finish keywords as follows:
  825.  
  826.         matte
  827.         smooth
  828.         glossy
  829.         metallic
  830.         reflective
  831.         glassy
  832.         luminous
  833.  
  834.  
  835.     as_follows ... end_as_follows - allows insertion of POV texture syntax.
  836.         Refer to POV documentation (outside of this document but see
  837.         Samples - Chandelier).
  838.  
  839.     External_texture, external_pigment, external_normal, and external_finish -
  840.         these refer to pre-defined definitions by name (note this is case-
  841.         sensitive).  See Samples - Chandelier.
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848. BLOCK DIRECTIVE:
  849.  
  850.     The BLOCK directive is used to:
  851.  
  852.         - define a representative block
  853.         - define a boolean operation
  854.         - define a "blobbed" object
  855.         - define texture that may or may not "fit" around a block
  856.         - define other settings that affect the objects inside the block
  857.             and nothing else.
  858.  
  859.  
  860.     Format:
  861.  
  862.  
  863.     block <block name> │external <external name> [bounded_by <boundaries>]│
  864.                        │intersection                                      │
  865.                        │blobs...                                          │
  866.  
  867.         [smooth_angle <n>] [block_texture...]
  868.  
  869.         [top_bevel <nnn>] [right_bevel <nnn>] [bevel_iangle <nnn>]
  870.             [bevel_side <nnn>]
  871.  
  872.         [2d_thickness <nnn>]  [2d_width <nnn>]
  873.  
  874.  
  875.  
  876.     BLOBS:
  877.  
  878.         blobs [threshold n] [strength n]]
  879.  
  880.  
  881.     BLOCK_TEXTURE:
  882.  
  883.  
  884.         <Texture options> │no_fit │ │no_transform│
  885.                           │fit    │ │transform   │
  886.                           │fit_all│
  887.  
  888.  
  889. Notes:
  890.  
  891.  
  892.     The <block name> is the name of the block in the dxf file.
  893.  
  894.     The EXTERNAL keyword denotes the block as being defined elsewhere and is
  895.         use in conjuntion with the INSERT directive (see below). The
  896.         BOUNDED_BY keyword defines to REALIZE what the external blocks
  897.         boundaries are in the x,y, and z directions.
  898.  
  899.     The INTERSECTION keyword indicates that the members of the block are
  900.         treated as components of a boolean intersection (see Samples).
  901.         A member whose color number is > 7 is subtracted (or inversed).
  902.  
  903.     The BLOB keyword converts the members of the block into "blobs" - see
  904.         Samples (very interesting!).
  905.  
  906.     The BLOCK_TEXTURE keyword has a syntax similar to the TEXTURE directive.
  907.         It accepts all the options of TEXTURE with the addition of the
  908.         indicated options.
  909.  
  910.     The fit, no_fit, and fit_all keywords refer to fitting the bit image around
  911.         the object (the block, in this case).  For fit option, the texture is
  912.         scaled uniformly to enclose the object completely, using the longest
  913.         axis as a guide.  It is then translated into place. For fit_all option,
  914.         the same applies except the texture is scaled non-uniformly.  For
  915.         transform, a translation is applied to the texture so that the textures
  916.         "center" coincides with the objects center. Fit_all and transform are
  917.         the defaults.
  918.  
  919.     The smooth_angle, top_bevel, right_bevel, bevel_iangle, bevel_side,
  920.         2d_thickness, and 2d_width parameters all have the same effect as
  921.         their GLOBAL directive counterparts but affect only the members
  922.         of the block (see GLOBAL directive).
  923.  
  924.  
  925.  
  926.  
  927. LAYER DIRECTIVE:
  928.  
  929.     The LAYER directive is basically the same as the BLOCK directive with the
  930.         same syntax - the only difference is that the EXTERNAL option is not
  931.         available.
  932.  
  933.  
  934.  
  935.     Format:
  936.  
  937.  
  938.     layer <layer_name> [│intersection  │]
  939.                         │blobs...      │
  940.  
  941.  
  942.         [smooth_angle <n>] [layer_texture...]
  943.  
  944.         [top_bevel <nnn>] [right_bevel <nnn>] [bevel_iangle <nnn>]
  945.             [bevel_side <nnn>]
  946.  
  947.         [2d_thickness <nnn>]  [2d_width <nnn>]
  948.  
  949.  
  950.  
  951.     BLOBS:
  952.  
  953.         blobs [threshold n] [strength n]]
  954.  
  955.  
  956.  
  957.     LAYER_TEXTURE:
  958.  
  959.  
  960.         <Texture options> │no_fit │ │no_transform│
  961.                           │fit    │ │transform   │
  962.                           │fit_all│
  963.  
  964.  
  965.  
  966.  
  967. INSERT DIRECTIVE:
  968.  
  969.     This directive is used in conjunction with the EXTERNAL... options in the
  970.         BLOCK directive and ...TEXTURE keywords.  The INSERT directive has
  971.         to be used to indicate to REALIZE which files have to be included
  972.         in the .pov that will be generated.  Representative blocks, for
  973.         example, have to be defined to POV (see defaultp.rdr file and Samples
  974.         for representative blocks). Often the order of the POV directives are
  975.         important.
  976.  
  977.  
  978.     Format:
  979.  
  980.  
  981.     insert │at_start       │ begin_insert <POV directives...> end_insert
  982.            │at_end         │
  983.            │before_textures│
  984.            │after_textures │
  985.  
  986.  
  987.  
  988. Notes:
  989.  
  990.     The POV directives have to follow the POV description language syntax.
  991.         The INSERT directive is mostly used to "#include" files that have
  992.         external definitions (see Samples - Chandelier and others).  Do not
  993.         use this directive for anything else unless you know exactly what
  994.         it will do.  It may be a source of unexplicable error messages
  995.         when you try to render it with POV.  Try and learn the POV syntax
  996.         first if you want to attempt something really fancy.
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002. Part 9. Tips
  1003.  
  1004.  
  1005.  
  1006.     Camera and Light Placement.
  1007.  
  1008.     Ideally you would use your CAD package to "preview" the final image by
  1009. specifying a perspective view before generating the dxf file.  In AutoCad,
  1010. a DVIEW command may be executed and a "distance" specified.  The resulting
  1011. 3D perspective image in AutoCad can then be assumed to be a preview of the
  1012. final POV generated image.  REALIZE also allows named views or viewports
  1013. (see Command Line Options and Directive File).  If no named view is specified
  1014. then the active or current view is assumed.  If this is not a perspective
  1015. view then REALIZE attemps to generate its own.  The AutoCad DVIEW command
  1016. also allows the camera and target position to be specified as coordinates.
  1017. This also results in a "preview".
  1018.  
  1019.     Usually the automatic light is adequate for most renderings. However,
  1020. REALIZE comes with special representative blocks, Sun and Light to allow
  1021. more realism (see Representative Blocks).
  1022.  
  1023.  
  1024.     Higher or Lower Image Resolution.
  1025.  
  1026.     Editing the file pov.bat in the \realize directory allows different size
  1027. images to be rendered by POV. The default is 640 width by 480 height. In
  1028. changeing the sizes, the ratio of width by height is usually kept the same
  1029. to avoid distorting the image. The higher the size, the better the resolution
  1030. and the longer the rendering time.
  1031.  
  1032.  
  1033.     Special Application Blocks.
  1034.  
  1035.     Some CAD packages like AutoCad have special applications that generate
  1036. special blocks that may be not be directly convertable by REALIZE. Some
  1037. blocks produced by AutoCad's AME for example need to be repeatedly "exploded"
  1038. until they are resovled into simple 3D entities before REALIZE can properly
  1039. convert it. Externally referenced blocks have to be manually inserted and made
  1040. part of the dxf file for REALIZE to treat them properly.
  1041.  
  1042.  
  1043.     Running out of memory in POV.
  1044.  
  1045.     Consult the file "povmod.doc" in the POV documentation on how to increase
  1046. the virtual memory size to sucessfully render the larger models and samples.
  1047.  
  1048.  
  1049.  
  1050. Part 10. About POV
  1051.  
  1052.  
  1053.    Where to get POV.  The following are the best sources (according to
  1054.         povray.doc ver 2.1):
  1055.  
  1056.  
  1057.     - Graphics Developer's Forum on Compuserve - GO GRAPHDEV
  1058.  
  1059.     - PC Graphics Area on America On-Line - PC Graphics section of AOL. Jump
  1060.         keyword is "PCGRAPHICS".
  1061.  
  1062.     - You Can Call Me Ray BBS in Chicago - (708) 358-5611
  1063.  
  1064.     - The Graphics Alternative BBS in El Cerrito, CA
  1065.         510-524-2780 (PM14400FXSA v.32bis 14.4k, Public)
  1066.         510-524-2165 (USR DS v.32bis/HST 14.4k, Subscribers)
  1067.  
  1068.     - Pi Squared BBS Maryland - CIS: 72114,2060
  1069.  
  1070.     - INTERNET - alfred.ccs.carleton.ca (134.117.1.1)
  1071.  
  1072.  
  1073.  
  1074.  
  1075. Part 11. Error Messages
  1076.  
  1077.  
  1078.     REALIZE
  1079.  
  1080.         The REALIZE directive file parser error messages have the format:
  1081.  
  1082.         *** ERROR - <ErrorMessage> on line 99 in <b> file
  1083.  
  1084.     Which may indicate illegal or missing values, syntax errors, and invalid
  1085.     keywords.
  1086.  
  1087.         Operational errors usually come in the form:
  1088.  
  1089.         <file> <type> open error
  1090.  
  1091.     The type may be read or write. This may indicate trouble with your hard
  1092.     disk- it may be too full.
  1093.  
  1094.         Other errors indicate the absence or a problem with the indicated
  1095.     file.
  1096.  
  1097.  
  1098.  
  1099.     POV
  1100.  
  1101.         The POV parser may display warnings which may be ignored.  Fatal errors
  1102.     are usually caused by the lack of the proper "#include" statement in the
  1103.     insert directive in the directive file (see Directive File and Samples).
  1104.  
  1105.         Other POV errors may be caused by lack of virtual memory.  Consult
  1106.     the POV documentation for the explanation.
  1107.  
  1108.  
  1109.  
  1110.  
  1111. Part 12. Definition of Shareware
  1112.  
  1113. Shareware distribution gives users a chance to try software
  1114. before buying it. If you try a Shareware program and continue
  1115. using it, you are expected to register. Individual programs
  1116. differ on details -- some request registration while others
  1117. require it, some specify a maximum trial period. With
  1118. registration, you get anything from the simple right to continue
  1119. using the software to an updated program with printed manual.
  1120.  
  1121. Copyright laws apply to both Shareware and commercial software,
  1122. and the copyright holder retains all rights, with a few specific
  1123. exceptions as stated below. Shareware authors are accomplished
  1124. programmers, just like commercial authors, and the programs are
  1125. of comparable quality. (In both cases, there are good programs
  1126. and bad ones!) The main difference is in the method of
  1127. distribution. The author specifically grants the right to copy
  1128. and distribute the software, either to all and sundry or to a
  1129. specific group. For example, some authors require written
  1130. permission before a commercial disk vendor may copy their
  1131. Shareware.
  1132.  
  1133. Shareware is a distribution method, not a type of software. You
  1134. should find software that suits your needs and pocketbook,
  1135. whether it's commercial or Shareware. The Shareware system makes
  1136. fitting your needs easier, because you can try before you buy.
  1137. And because the overhead is low, prices are low also. Shareware
  1138. has the ultimate money-back guarantee -- if you don't use the
  1139. product, you don't pay for it.
  1140.  
  1141. DISCLAIMER - AGREEMENT
  1142.  
  1143. Users of REALIZE must accept this disclaimer of warranty:
  1144. "REALIZE is supplied as is.  The author disclaims all
  1145. warranties, expressed or implied, including, without limitation,
  1146. the warranties of merchantability and of fitness for any purpose.
  1147. The author assumes no liability for damages, direct or conse-
  1148. quential, which may result from the use of REALIZE."
  1149.  
  1150. REALIZE is a "shareware program" and is provided at no charge
  1151. to the user for evaluation.  Feel free to share it with your
  1152. friends, but please do not give it away altered or as part of
  1153. another system.  The essence of "user-supported" software is to
  1154. provide personal computer users with quality software without
  1155. high prices, and yet to provide incentive for programmers to
  1156. continue to develop new products.  If you find this program
  1157. useful and find that you are using REALIZE and continue to use
  1158. REALIZE after a reasonable trial period, you must make a reg-
  1159. istration payment of US$50 to Transcendental Technologies.  The US$50
  1160. registration fee will license one copy for use on any one
  1161. computer at any one time.  You must treat this software just like
  1162. a book.  An example is that this software may be used by any
  1163. number of people and may be freely moved from one computer
  1164. location to another, so long as there is no possibility of it
  1165. being used at one location while it's being used at another.
  1166. Just as a book cannot be read by two different persons at the
  1167. same time.
  1168.  
  1169. Commercial users of REALIZE must register and pay for their
  1170. copies of REALIZE within 30 days of first use or their license
  1171. is withdrawn.  Site-License arrangements may be made by con-
  1172. tacting Transcendental Technologies.
  1173.  
  1174. Anyone distributing REALIZE for any kind of remuneration must
  1175. first contact Transcendental Technologies at the address below for
  1176. authorization.  This authorization will be automatically granted to
  1177. distributors recognized by the (ASP) as adhering to its guidelines for
  1178. shareware distributors, and such distributors may begin offering
  1179. REALIZE immediately (However Transcendental Technologies must still be
  1180. advised so that the distributor can be kept up-to-date with the latest
  1181. version of REALIZE.).
  1182.  
  1183. You are encouraged to pass a copy of REALIZE along to your
  1184. friends for evaluation.  Please encourage them to register their
  1185. copy if they find that they can use it.  All registered users
  1186. will receive a copy of the latest version of the REALIZE
  1187. system.
  1188.  
  1189.  
  1190.  
  1191. Part 13. Registration
  1192.  
  1193.  
  1194.     How To : Fill in the details in the file rego.frm. Print the file, send
  1195.     it and your international check or bank draft for US$50 by mail to :
  1196.  
  1197.     Transcendental Technologies
  1198.     17 Beechwood cl.
  1199.     East Doncater Vic. 3109
  1200.     Australia
  1201.  
  1202.     PLEASE DO NOT SEND PERSONAL CHECKS as they cost more than $50 to clear!
  1203.  
  1204.  
  1205.     Benefits :
  1206.  
  1207.     1) The latest version of REALIZE minus the evaluation package notice.
  1208.  
  1209.     2) The full representative block library including:
  1210.  
  1211.         a) The alphabet, numbers and special characters.
  1212.         b) 4 more sizes of elbows
  1213.         c) 3 sizes of tapered cylinders
  1214.         d) 4 different kinds of fractal mountains and hills
  1215.         e) 4 different kinds of customizable tree models
  1216.         f) Additional blocks as they become available.
  1217.  
  1218.     3) Additional advanced, fully-annotated samples.
  1219.  
  1220.     4) Support (by mail) is provided for 3 months.  This includes answers to
  1221.         relevant queries and bug fixes (for non-trivial bugs).  For any problem
  1222.         involving a specific hardware and/or software environment or feature,
  1223.         Transcendental Technologies may elect not to modify the program.  In
  1224.         this case, if the problem is reported within 3 months of registration,
  1225.         Transcendental Technologies will offer a refund of the registration
  1226.         fee.
  1227.  
  1228.     5) A chance to win $100.  Just send us your masterpiece and if we decide
  1229.         to include it in the Registered package as a sample you get the money
  1230.         and the acknowledgement.   All contest entries become the property of
  1231.         Transcendental Technologies.
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.